home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 21
/
Cream of the Crop 21 (Terry Blount) (October 1996).iso
/
os2
/
commo70.zip
/
ADDENDUM.DOC
< prev
next >
Wrap
Text File
|
1996-08-24
|
11KB
|
298 lines
{COMMO} 7.0 Addendum
_____________________
This Addendum contains the major additions and/or changes to the
{COMMO} 6.6 documentation. Print out this file and keep it with your
printed manual. There is a complete list of changes (major and minor)
in the file HISTORY.
===============================
In the User Guide and Reference
===============================
Under "[Alt-G] Edit Setup File"
--------------------------------
_____________________________________
{com=1,3f8,4} Com1 port address/IRQ
{com=2,2f8,3} Com2 port address/IRQ
{com=3,3e8,4} Com3 port address/IRQ
{com=4,2e8,3} Com4 port address/IRQ
_____________________________________
These are the hardware serial port base address and IRQ
assignments (the settings shown are the defaults). COM3 and COM4
usually require a different IRQ setting.
NOTE: If you need to define more than four ports, you can add
extra "com" items (up to "com=16,...").
Port addresses are in hexadecimal and may range from 0 to ffff
(use addresses below 200 with caution). If the documentation
shows a range of addresses, such as "3f8-3ff," use the first
value as the base address.
IRQ numbers are decimal and may range from 2 to 15 (avoid use of
IRQ numbers that are used by system hardware, such as 6, 8, 13 or
14). If your serial port hardware is configured for IRQ 2, you
may get better results on AT class machines if you specify IRQ 9
in {COMMO}.
The serial port base address and IRQ number for the current port
are available to macros in the built-in variables "_pad" and
"_irq" respectively.
You can also specify the maximum speed or "frequency" for each
serial port by adding a fourth parameter (default is 115200).
For example, if you have a port that has a frequency of 256000
you might have:
{com=4,2e8,5,256000}
The frequency value is the speed that results when the Baud Rate
Divisor is equal to one (which is usually the crystal frequency
divided by 16). It may be as high as 40,000,000 bps.
_________________________________________________
{min=auto} Send Modem Init String (auto/yes/no)
_________________________________________________
If this is set to "auto" {COMMO} will send the Modem
Initialization String at program startup only if carrier detect
is off. This allows you to exit the program and restart while
still online.
If "yes" {COMMO} will send the string regardless of the state of
carrier detect. If "no" {COMMO} will not send the string.
You can override this item with the "/iy" or "/in" command line
switch.
_________________________________________________
{vsp=3} Variable Space size in kilobytes (1-64)
_________________________________________________
This may need to be increased if you run macros that use a lot of
variables. Usually the author of the macro will indicate how
much space is required.
Under "[Alt-U] Utility Menu"
-----------------------------
The Utility Menu contains a selection of features supported by macros
in COMMO.MAC. Current features include:
Add an entry to the Dialing Directory.
Set current terminal emulation.
Run the host mode macro, MOSTHOST.MAC.
Edit the host mode macro.
Edit any external text file less than 64k in size.
Run any macro by name (label).
Load any auxiliary Macro File.
Unload the current auxiliary Macro File.
Modify certain setup items for the current session.
Toggle the Speech Friendly Interface ON/OFF.
NOTE: The Utility Menu may not be available (or may have different
features on its menu) if an auxiliary Macro File has been loaded.
==============================
In the Macro Programming Guide
==============================
-------------------------------
Additions to existing functions
-------------------------------
Under INPUt, switches
---------------------
Ln
Length of the input field, "n" may range from 1 to 120
(default is 60).
Under SETEsc, switches
----------------------
K0
Ignore all typed keys except Ctrl-Break (i.e., lock the
keyboard). If a macro label is included, the macro will be
executed when Ctrl-Break is pressed (there will be no
prompt). Otherwise Ctrl-Break causes the macro to STOP. In
either case, the keyboard is active again as soon as Ctrl-
Break is pressed.
NOTE: System keys such as Ctrl-Alt-Del, Shift-PrtSc,
NumLock, etc., are not affected (they remain active).
K1 or K
Allow all keys (default).
Under SETLook
-------------
Default key: none
Description: Set parameters for LOOKfor functions.
General form:
{SETLook seconds,label,seconds,response}
seconds
LOOKfor timeout. Maximum time in seconds to look for
strings. If no string is found in the allotted time,
the macro in the second argument will be started. May
be 0 to 999. Note that this timer is restarted
whenever a string is sent by SSLOok. Default is 0
(disabled).
label
Timeout macro. Macro to GOTO if the time in the first
argument expires. If no macro is specified or if the
macro label is invalid, control will pass to the
function following the LOOKfor.
IMPORTANT! If the LOOKfor is in a CALLed subroutine,
be sure to execute a RETUrn or POPS at the label.
seconds
"No data" timeout. If no characters are received from
the remote system for the specified amount of time,
{COMMO} will take action as indicated by the "N" switch
(see below). The timer is restarted whenever a
character is received. May be 0 to 999. Default is 0
(disabled).
IMPORTANT! The timeout should be long enough (or
disabled entirely) to prevent a premature response.
response
This argument is a string or a macro label depending on
the setting of the "N" switch (see below). Default is
no string or label.
Switches:
N0
The response argument is a string (up to 32 characters).
This is useful if unexpected prompts appear, such as "Press
any key" or "More [Y/n]". Specify a generic response such
as "|" or "n|" and {COMMO} will send it each time the "no
data" timer expires (default).
NOTE: The timer will be restarted after the response is
sent or if any keys are typed while waiting (allowing a
manual response to a prompt which the macro does not
handle).
N or N1
The response argument is a macro label. If the "no data"
timer expires, {COMMO} will GOTO the label.
Examples:
{setl 60,abc,4,n|}
The LOOKfor timeout is set to 60 seconds; GOTO "abc" if the